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This Meao. describes two small utility programs that are of assistance 

in using the ITS 1.4 (see A.I. 161, MAC-M-377) tin* sharing system. 

LOCK perform© miscellaneous utility functions while PEEK displays, 

vith periodic updates, various aspects of the time sharing system's status. 



P2HX and IflCK Fare 1 



J* Introduction 2 

2. PEST 2 

2.1 Introduction 2 

2.2 Modes Available 4 

2.3 10 Control 9 

2.4 miscellaneous 10 

3. WOC n 
3.1 Introduction 11 
7> .2 ComMnds 11 

References 14 

Appendix. Illustrative Console Output 15 



PSHC and LOCK Page L 



1. Introducti 
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This neno describes two small utitlty rrorramr that are 
relavent only to use of the ITS 1.4 time sharing system. This 
time sharing system is described, as of June 1968, In memo 
HAC-V-377 net 2J vhich Is frequently refered to hy this memo. 
The same notatlonal schema is used in this memo as described in 
section zero of tUC-H-377 with the addition of the rotation [Pef 
x*Sec y(, |, ...)] for sectioo(s) y{, z, ...) i n reference i, for 
example {Ttef 2*Sec 01. 

The first pro-ram herein discussed, ?2EK, provides 
periodically undated displays of Tarlous aspects of the time 
sharinff system's status. The second and saaller program, LOCK, 
performs a variety of miscellaneous functions. 

Artificial Intelligence Group nemo ai W7[Ref 1J is 
extremely relevant to the usual loading and transfer of control 
to the within described pro?raas. 

3ote that the commands P, Q, and ? have the same meaniw for 
both programs. The ? command causes each of them to print a list 
of their commands with short explanations. 
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2. P33S 

* 

2*1 Introduction 

PEEK is & utility prorrai operating under ITS fRef 2). It 
enables & user to monitor a variety of aspects of the tise 
sharing system by providing periodically updated display output 
or periodic character string output to teletype or line printer. 
Coaraands to PKSK are single letters ^onetimes preceeded by 
nuaeric ar^uraents. When initially started, PIKE is la H f or 
normal, mode ISec 2,23« If the user Is on a GE console [Ref 
?*Sec 4,5] PEIX will initially start outmitin* by typing (vhlch, 
on a G2 console, is effectively dlerlayln*). If the user is on a 
teletype, PEEt will try to seize the 340 disrlay (Ref 2>Sec 4.11) 
and either display on the ^40 or type its output depending on 
whether H succeeds or fails, respectively. This nay be 
disconcerting If you are at a teletyre not In view of the 340 
because It vlll appear that the PEEK is Just sitting there. This 
can be rectified with the A !J conmand [Sec 2.3J, 

The first line of all pa^es output by P2EK is as follovs: 

ITS xxx PEEC yyy mm/dd/yy hh:mm:ss 
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where jxx is the version number of the system in use tBef 2>5ec 
7 .6,31, yyy is the version number of the PES in use (so bu^s can 
be matched to exact version), and mm/dd/yy is the date and 
hh:mm:ss the time according to ITS [Pef 2>Sec ?.3.2, 7.3.3). The 
last line of all ra*es displayed on the 340 by P2EK Is a list of 
mode coraands which can be Mven by li^bt^penniws [Ref 2>Sec 
7.11.2) the* with effects identical to tynin* then. 

All characters typed at PEEK are Interpreted al its 
interrupt level and have effect, if any, immediately. Character? 
that are not Goawids, di^it? f or *Z are completely ignored. 
Dibits are accumulated as an octal nuaber until a non-di?ll is 
typed at which time the accumulated number is made available (if 
the non-di*lt is a conmand taMn* a numeric argument) and reset. 

The aaount of memory occupied by ?E1K varies with node but 
the present minimum Is three memory blocks (a total of 6000 
words h 
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2.2 Modes Available 

* 

roe particular subset of the time sharing system's status 
beinr output by PEEK Is controlled by Its node. Initially PES 
is in H mode but It may be chawed to any of those listed below 
by typing the letter indicated or lteht penning IRef 2>Sec 
4*11, ?! it if PEEK is displaying on the ?40. Unless othervi&e 
specified the output repetition rate for these modes is the 
standard rate initially set to 5 seconds delay after end of j&*t 
output before starting on the next update. This is variable by 
the user with the Z coaoand [Sec 2.4J. 



D This node outputs Data-disk directories [Sef 2>Sec 

4.2], It is normally preceeded by a drive number. If outrut is 
being tyned, the standard systea generated directory is used [Ref 
2>Sec 3.2.1). If outnut is to the 340 or line printer, an 
expanded form is used. The lover rert of this form is similar to 
the system supplied directory. It has an additional number after 
the file name and before its length* This nunber is a pointer to 
the first physical block used by the file (minus one indicates a 
file of length zero). The upper part of this form is the list 
structure area of the directory which has for each physical block 
either the number of the next block in the file containing it f 
ninus one if it is the last block in a file, or zero if it is 
unused, 

G This node lists the slxbit symbols recognized by 

.G3TSYS TRef 2>Sec ?.6.3) in the systeia in use* Output is 
updated after a ten second delay. 

H Only available with the 340 display, this mode 
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outputs a graph of memory with different nemory users on 
coorJU5te VertlCal leVClS ** locallon "Presented by horizontal 

I The symbolic devices implemented in the systea in 

use rBef 2>App 3) are listed by this mode. Output is updated 
aiter a ten second delay. 

M This mode is somewhat reminiscent of H node. It 

lists all memory users and the amount of meaory tbey are using in 
decreasing order. An "•" is also output by stopped jobs as are 
the character* for special resources being used by any lob (see 
>able below). 

H This is the most frequently used mode of PEEC. U 

tries to give a snapshot of the status of all user jobs in the 
ays tea. Different amounts of information are displayed derendin* 
on the particular output device in use, but in all cases the 
following additional infornation is output: 

m«.w t u JiL A1WT S {"• llsl of »" r jobs, the number of free 
bloc** (each 2C00 words) of aenory (MEWR), the nunber of areas 
that are allocated for user variable [Sef 2>App CJ (USREI), and 

tHJSSr* USer pr0?rafflE that we " runnable last schedule time 

(2) Belov the list of user jobs, the number of 
Blocka rt nem "y occupied by user programs (USR MB!) (the sua of 
this figure and MEKPR is not constant due to dynanlc 10 buffers), 
the total rercenta^e of machine time bein* used by the listed 
pro-rams {DSR TIK) (less than one hundred due to scheduling and 
other airhead), the amount of tlae that the running system has 
been up (STIM*), and the total amount of machine tiae used by 
users that have logged out (LOUTIM). 

th™. «„ ™ ?? twee * f h ! lvo ! ets , of Information described above, 
S2L I on \H? e ?f Information for each procedure In the system 
topped by a title line which provides a heading for each column 
oi information. The first item on the line for any particular 
Procedure will be the user Index of the procedure, a number that 
uniquely refers to it (see mode V). The second item will be 
eitner the OTAME for top level procedures and the JKAMZ for 
inferiors or the MAMS, JKAMS, and SKAMS for each procedure 
depending on the line vldth of the output device. This second 
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Item also portrays the existant procedure tree structure in that 
each ^orcedure not at the ton level is an inferior of the nearest 
procedure above it Khose naae if not indented as far. 

Other iteis include an exponential approximation to 
the percentage of machine time the procedure has beer receiving 
the number of core blocks It is occupying, a colunn labeled "1TY" 
that has * M T" concatenated with the console nuiber opposite 
procedures controlling a console, various letters immediately 
after the "TTY* 1 column for systea resources controled by the 
procedure (see the table below), and a column labeled "STATUS**. 
The character string opposite a procedure in the STATUS column 
should be interpreted as follows: (l) a leading "*" indicates 
that the procedure is processing a software interrupt IRef 2>Sec 
5,21, (2) n R3H" indicates that the program is running in user 
mode, (3) a pair of numbers separated by an "J" indicates that 
the procedure is sloped, (4) most other strings represent a 
systen call (with S used for the very comnon .SLESP call) or 
input-output device and type of transfer; (4A) If preceeded by a 
"+" the procedure is running in executive aode performing the 
call or lnr«t-output; (43) if not it is hung on the call or 
Input-output, 

T The contents of the system translation table [Ref 

2>Sec 3*3] is outj^t. 

U Ibis mode displays the status of the DEC tape drives 

[Hef 2>Sec 4,11 and of open DEC tape files. For the noraal user, 
the most useful information per tape is the drive nuBber in the 
leftmost cnlusn and the DIR variable in the next to the rightmost 
(U7ASS) column. If the DIR variable is minus one, ITS is not 
retaining a directory for that drive and a tape mounted on it 
could be removed manually. Otherwise It is the absolute location 
of the directory. The per open file Information includes the 
names of the procedure usin* the file, its direction, and the 
number of buffers (200 words each) currently teinp used for the 
file hy the system. 

V This mode command should be proceeded by the user 

index (see mode S above) of some user. It displays many of his 
user variables tRef 2>Apn CI and the channel word and status vord 
for each of his input-output channels [Ref 2>Sec 3.1, 8,6)« If 
output is to the 340 or line printer, the contents of the 
selected users accumulators are also output. 
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_,../, . ^; b node o«t™tB the dWtalUation of all the 

the value belt* outrut on each of the multiplexed dlHtal \o 
analo» channels [Sef 2>Sec 4.10J. "»*« aisital to 

This mode outnuts system supplied [Ref 2>Ser S ? n 
n,^-° rleS f0f ** Upes - " should * Proceeded by a dr-We 

pttt'I mum. ? is ? ndfi out rutf a "fit and brief explanation of 

I?Ua2rS?I; «*?.!* f ^Vi ! nClUded ln the *W«*l*. Output 
is updated atter a ten second delay. 



The following are the systen resource letters used in mode; 
?1 and M abo?e: 



tn ,»$ „ I^icate? that the procedure U nov or was the last 
to use the core allocator, 

the m 340 il%\ltT tbat the procedure haE selzed coatro1 of 

device ^Wcates that the procedure has control of the COD 



I 



pijs letter can be present for more than one 



printe ^cates that the procedure has control of the line 

IU..U !«.« Indicates that the procedure has placed itself In a 

S£ SS^iM?* seue the *° di8rlay and i9 scheduled 

P Indicates that the procedure has cortrol of the 
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plotter. 

< H Indicates that the procedure ha? control of the 

paper tare reader. 

T Indicates that the procedure has control of the 

paper ta^ punch. 
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2.3 10 Control 

- 

PS7K will outwit to only one device at a tine. The initial 
device Is chosen as explained in section 2.1. All of the 
following four comsands for chan*inf PEEK's output device also 
cause PKEK to fawdlately restart output for Its current mode 
ISec 2.21: 

.,*?. .™ s "Itches output to the line printer if It is ' 
Mailable. If not available the output device will be unchanged. 

«rt*t2i „ - ThlS co ™ and vin terminate P£EK output to the line 
printer and cause It to either type or display its output. 

*«../?„* . ^'f C01 ? ,iand teralnates 340 diplay output, starts 
^PSLS^Jf J? 1 " ? fla * in PEffi that is <*»™d only by the 

as S5S* K^SK^^i!"- ra ■ attempts l0 seIze "» « 

*Y PSKK vlll atteopt to seize the 340 display for 

ImlM 6 ;:'? 1 ! f m l C ° m ^- " U IS ""MCCMfil, Output 

ablJe is cleared^ *' ^ W " W lhe flW Benlloned ™ der ** 
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2,4 Miscellaneous 



The following are miscellaneous P2EK commands: 



P Under norrtal circuastances, this coraand will return 

control of the user? console to DDT [Sef 11 tot leave PEIE 
running and, if the MO display or line printer is selected, 
rnjducirv* output, 

Q Under normal circumstances, this command will 

destroy the PET2T it is typed at and return control of the users 
console to PDT« 

Z This command should be rroceeded hy a snail number. 

It sets the standard update delay to as many seconds [Sec 2.21. 

■ This command will probably *o away when swapping Is 

added to the system. finder rtdrMl ciMuastaaees it will cause 
the procedure tree in which is found the FEES it is tyred at to 
be replaced by a single newly loaded PEEK at the top level. This 
saves memory if several people want to leave a PEEK at a sin gle^ 
console running for their joint enlightenment. A top level ?*5K 
will coa*it suicide if a A Z is typed at it. 
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3. LOCK 

■ 

3,1 Introduction 

UCtf Is a utility program operatin* under ITS terforninr a 
multitude of Infrequently required tasfcs. Its nace derives frotu 
the fact that the function it was originally written for was to 
"lock" and "unlock** teletypes (see the + and - commands [Sec 
3,21). Host of lOCK's conrands are single characters. 

In contrast to PXK f which interprets conmands at the 
Interrupt level, ccmmaTids to LOCK are read at its Min rwraa 
level. Thus comrands will in general have no effect before 
previous cocmands have been completed. In fact, sove commands 
cause a change in the state of LOCK such that following letters 
arc interpreted as ar^inents* 

LOCK occupies only one block {2000 words) of semory except 
in node **T*\ 

3,? Commands 

The following are the current LOCK conaands: 
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+ This command should be proceeded by a teletype (or 

Gl console) number (Ref 2>Sec 4.51. The LOCK will try to open 
the -specified teletype as an input-output device. It will be 
succesful only if the teletype is not in use. If it is 
successful, the teletype will become inpervious to *Z*s so no 
user can lor in on it t I/3CK vill type out an appropriate message 
on the now locked teletype, and LOCK will type a "U" to the UKK 
user. If the I0CK fail? in orenirw the teletype it vill type an 
m V at the LOCK user. 

This command should be proceeded by a teletype 
number* If IOC* has the specified teltyne locked it vill unlock 
it and type out an ■**. Otherwise it vill type a "?". 

_ This coanend should he preceeded by the octal code 

for a~character. LOCK will type out the character represented. 

C This command should be preceded by the user index 

ISec 2.2, see mode R) of the top procedure in a tree that the 

user wishes to obliterate. It must be followed by the characters 

"OH". If the user deviates froa this sequence, a "?" vill be 
typed and IOCK vill listen for a new comaand. 

I A series of ma*ic characters must be typed at a 

model 37 teletype to allow its use in full duplex, the mode 
assumed by most programs operating under ITS, This command 
causes LOCK to tyr* the requisite characters, 

K This comaand must be inmeiiately followed by the 

characters "ILL" (see G above) and should be preceded by a 
number. It will activate the system going down feature of ITS 
with a tine Unit of five or the number preceediiw the command 
minutes, whichever is larger. 

When it receives this command, LOCK will permanently 

M into a moie where characters typed at It are echoed as there 
ASCII value in octal. To ultimately escape frotn LOCK In this 
mode, the user should use *Z. 

P Under nortaal circumstances, this command causes 

control of a users console to revert to his DDT [Kef 11. 

Q Under normal circumstances, this command causes 
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KM ItfSLLg: deslr0! " a wcs " 4e!lr01 ^ a fro « dm 

S This coanand coaicleients the ran status of the 

system checWng feature of the system job [Pef 2>Sec 7.51. It 
viii type out the resultant state as either "START" or "STOP" 

This comraand causes complex and nonterminatlnp 
gyrations on the cart of the LOGS it is typed at and the 

KS"^ ?% M ?«i: 111 Create as a resu,t of Lhls ^mand. ". 
purpose is to test the core allocator tRef 2>Sec 5,3) ard other 

components of the ITS systea. Its casual use is not rSoJSSd. 

i... ? * .. Thls c , 07tmn4 causes LOCK to tyre out an u* to date 
lis. of its commands with a brief explanation of each/ An 
exaaple apnears in the appendix. 
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Appendix. Illustrative Console Output 

The following pa?es Illustrate the current self 
documentation output of P2EC [Sec 2] and LOCK [Sec 31 and the T 
node tSec 2.21 output of PEEK. A few DDT [Ref 1] commands are 
illustrated in passing. 



Page 16 



*Z 



DDT. 159. 












SEE META MEMO ON CONSOLE 


. — F 


!,G. 


- ****— ^et*/, J^ 


OEESU 


* 








■"■ -<t»^*-*i 


".PEEK 1 










— -<i-**/ /££ « 


tN 










1«*:1SS36 


ITS im«J PEE* 


: 12 't 


12/96/4 


MEMFR-53 


USRHI-H 


t 




RNABLU-1 


1- U-J1Ay£ 


STATUS 


TTY 


CORE J 




3 SVS 


TYO 


15 


26 


9$ 




1 CORE 


UUO 


? 


9 


at 




2 OEE 


S 


- 


5 


i% 




k PEEK 


♦ GE1SV 


19 C 


fi 


19? 




3 HA 


S 


- 


5 


« 




16 LISP 


TY1 


113 


23 


9<C 




5 RJF 

12 TECO 


S 

TYI 


112 


7 
7 


9$ 


- N ,^M ^*t*a 


| LISP 


1919 


7 


33 


9? 




o JRG 


S 


— 


6 


M 




10 PEEK 


1919 


? 


5 


a? 




11 CHESS 


TYI 


T7 


42 


M 




7 CEH 


S 


- 


17 


■* 




13 PEEK 


191 » 


? 


6 


9? 




15 HLISP 


TYI 


Till 


11 


3* 




USR MEM- 332 USR 


TIM- 1«! 






STIME ■ 5:. 


38:48 LOUT If 


- t2» 


38 





Pago 17 



I TS 444 PEEK 124 12/J6M8 1W22l*fi . *s~& 

MODE CONTROL: 

D CISK DIRECTORY (PRECEDE EY HUM) 

G AVAILABLE .GETSYS'S 

H MEMORY 01APH (34* QNLV> 

I AVAIU3LE 10 DEVICES 

M MEMORY ISE LIST 

N WW MA I HODE 

T TRANSLATION ENTRIES 

U DEC TAPE S TAILS 

V SINGLE USER {PRECEDE 3Y INOEO 
X MULTIPLEXORS 'ODE 

Y DEC TAPE DIRECTORY ("> - ? / * 

? EXPLANATION 'ODE ' ^*^ "~-^**>r 

10 CONTROL: 
»8 USE LINE PRINTER 
fE STOP (SING LINE PRINTER 
rY USE 348 
tN STOP US IKS 34! 
OTHER: 

PROCEED 8UT RETURN TTY TO DDT 

QUIT 

Z SET DOZE IN SECONDS 
! STAND ALONE 

Q 
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1L0CK I 

LOCK .39 
-? 



+ LXK TTY (PRECEDE BY £) 

- UNLOCK TTY ("J 

*■ OUTPUT CHARACTER WITH ftSCI I VALUE # C") 

GUH KILL U5ER WITH £ INDEX C") 

| INITIALIZE t M3DEL 37 TTY 

KILL SYSTEM DOWN IN g MINUTES (") ? 

OUTPUT CHARACTERS I U XTAL I 

P RETURN TO DOT 

Q VALRET AN Stx. 

S CONPLEMENT RUN STATUS OF SYS JOB 

T TEST CORE ALLOCATOR 

? LIST COMMANDS 



— /+-J »-J s£s>*- 



i.OC< 



fr-K-ftfrw*" 



: LOGOUT 

IIS If* COIfiOLE % FREE. 11t2*.:^2 



LOCK «^^— A- ^7" 



